Release 10.1A: OpenEdge Development:
ADM Reference

assignWidgetValueList

Takes the name of one or more objects and character screen values and a delimiter as input and sets the SCREEN-VALUE of the objects. The DataValue is set for a SmartDataField (this would always be the key field for a lookup even where the display field is different).

This function sets the DataModified attribute to force the toolbar to enable saving data (it behaves as if the user actually changed the field value manually). The DataModified attribute is set to TRUE whether the field is enabled or not.

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

INPUT valuelist AS CHARACTER

A string representing the intended screen values for one or more widgets separated by the specified or default delimiter.

If the name list contains more than one object, then the value list must be either a single value, which will be applied to each field in the name list, or it must be a list of an equal number of entries to the name list, in which case the values are assigned to the corresponding object names. If there is more than one entry in the value list and the number of entries in the namelist and the number of entries in the value list do not match, nothing is done and FALSE is returned. If any assignments fail because the widget is not found, FALSE is returned but it still processes through the list and assigns those that it can.

INPUT delimiter AS CHARACTER

(Optional) Specifies the delimiter to use for the value list. Specify “?” to use the default delimiter, which is the pipe character (“|”).

Returns: LOGICAL

Notes: For the DHTML client, the delimiter is optional as the third parameter. If it is not specified, the function uses the default, which is the pipe symbol (“|”).

Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

assignWidgetValueList("city,state":U, "Boston|MA":U, ?).

The following illustrates the use of this method in DHTML code for use with a Web browser:

lRet=logic.assignWidgetValueList('customerviewv.name,customerviewv.city', 'Reeds Ferry|Nashua');